Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Functions

DisposeMovie

The DisposeMovie function frees any memory being used by a movie, including the memory used by the movie's tracks and media structures. Your application should call this function when it is done working with a movie.

pascal void DisposeMovie (Movie theMovie);

theMovie

Identifies the movie to be freed. Your application obtains this
movie identifier from such functions as NewMovie, NewMovieFromFile, or NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

SPECIAL CONSIDERATIONS

Do not dispose of a movie if it has any special clients--for example, if it has an attached movie controller component. Only dispose of the movie after any clients are done with it.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid